home *** CD-ROM | disk | FTP | other *** search
/ Sound Fx / Sound Fx.iso / Software / ZIPED / FS105DEM.EXE / README.TX_ / README.bin
Encoding:
Text File  |  1995-04-05  |  6.1 KB  |  78 lines
  1. The files in the Default Names folder provide FreeMIDI with the default patch and note names for various synthesizers.
  2. When FreeMIDI detects that no editor/librarian program has been used for a device, it looks up the factory default names
  3. in the appropriate file.  The name of the synth's manufacturer is used to determine the sub-folder, and the name of the
  4. synth model is used to identify the file.  If no match exists, FreeMIDI uses the generic "Patch XXX" list.
  5.  
  6. These files use a simple text format to describe patch banks.  (Future versions will be able to specify note name lists
  7. as well.)  The first piece of information is the BANK NAME, enclosed in quotes.  This is followed by optional information
  8. about the bank which must appear on the same line.  This information includes the NUMBER OF NAMES in the list, the TYPE
  9. OF BANK being described (patch bank or note name list), any BANK SELECT values used, the CHANNELS to which the bank
  10. gets assigned, and a specialized MIDI MESSAGE that gets sent whenever the bank is selected.
  11.  
  12. The name list for the bank begins on a new line.  Information that can be provided about individual names (patches) includes
  13. the BANK SELECT AND PROGRAM CHANGE numbers used to select the patch, an ASCII STRING (up to 7 characters)
  14. identifying the patch in the synth's native format, and the PATCH (OR NOTE) NAME.  Only the name is required; defaults
  15. are used for the other values if they are not provided.
  16.  
  17. As a simple example:
  18.  
  19.     "Patch Bank" #4 -P (0 1) [1-16] {f0 0 0 0 0 0 0 0 0 0 0 f7}
  20.  
  21.     (0 1 0) [A11] "Patch 1"
  22.     (0 1 1) [A12] "Patch 2"
  23.     (0 1 2) [A13] "Patch 3"
  24.     (0 1 3) [A14] "Patch 4"
  25.  
  26. The name of the bank is "Patch Bank."
  27. The string '#4' tells FreeMIDI that the bank has 4 named entries.
  28. The string '-P' tells FreeMIDI that the bank being described is a patch bank; '-N' would be used to describe a note name list.
  29. The numbers in parentheses () identify the bank select controller values used.  In this case, the bank name corresponds to
  30.     controller 0 value 0 and controller 32 value 1.  Either one or two numbers may be used -- the numbers will only be
  31.     useful if the device model has one or both of the "Bank Select is Controller XX" properties.  The numbers must be in
  32.     decimal format (0 - 127).
  33. The numbers in brackets [] define the channels to which the bank gets assigned.  Channels can be specified individually
  34.     [1, 2, 3] or as a range [1-3].
  35. Enclosed in braces {} is a stream of MIDI bytes sent to put the synth into the proper mode so the patches in this bank can be
  36.     accessed.  The message must be described as hexadecimal bytes, and realtime messages (F8 through FF) should not
  37.     be used.  However, it may contain multiple non-realtime MIDI messages, not necessarily sysex.  The message will
  38.     get sent when the user first selects the bank in a session, and whenever he switches back from another bank.  To
  39.     specify a device ID placeholder, use the two characters "id" (without quotes).  If it is followed by a plus sign (+),
  40.     the following hex byte will get added to the device ID.  That is, the string {f0 id + 30 f7} for a device with ID 2 will
  41.     generate the MIDI bytes {F0 32 F7}.
  42. A colon (:) immediately following a MIDI stream can be used to specify a "mode" for the bank.  The message will get sent
  43.     only if FreeMIDI determines that a mode change must occur.  By default, banks will have mode 0, which means the
  44.     message affects a single channel only.  A positive mode indicates that the state of the device changes when the
  45.     message gets sent.  Put any decimal number after the colon to specify the mode; eg, {f0 0 f7}:1 .  FreeMIDI will not
  46.     recognize the mode number if there are any spaces or tabs before or after the colon.
  47.  
  48. The lines after "Patch Bank" describe each of the four patches in the bank.
  49. The numbers in parentheses () identify the bank select and program change numbers used for the patch.  If only one number
  50.     appears, it is used as the program change number.  If more than one number appears, the first one or two are used to
  51.     define the bank select numbers used when the patch is selected, depending on which bank select properties have been
  52.     assigned to the device.  The numbers must be in decimal format (0 - 127).
  53. The characters in braces [] define the synthesizer's native format identification for the patch.
  54. The name of the patch is enclosed in quotes.
  55.  
  56.  
  57. Guidelines and hints:
  58. ----------------------------------
  59. 1.  If you do not specify otherwise, banks will be assumed to have 128 patches.
  60. 2.  If neither '-P' or '-N' are used, the bank will be a patch bank.
  61. 3.  Banks will not use bank select controllers if you do not specify any numbers, or if you specify (-1, -1).
  62. 4.  By default, a bank will be assigned to all channels if you do not specify any.
  63. 5.  Banks will not have specialized MIDI messages if you do not provide one.
  64. 6.  Remember that all information about the bank itself must appear on the same line as the bank name.  Note that if a
  65.     bank requires a very long MIDI message, the message itself can span more than one line as long as the beginning
  66.     of the message begins on the same line as the bank name.
  67. 7.  When providing information about each patch, the name must appear last, and the ASCII string should appear after
  68.     the bank/program change numbers.
  69. 8.  If you don't provide bank/program change numbers for an individual patch, FreeMIDI will use the bank select
  70.     numbers provided for the bank and will increment the patch number for each successive patch.  You can speed
  71.     reading the file by listing patches consecutively and not providing patch numbers, and by specifying bank numbers
  72.     with the bank name and not for each individual patch.
  73. 9.  You can provide an ASCII string for the first patch and allow FreeMIDI to generate the strings for each successive
  74.     patch to avoid typing them all in.  The strings that you don't type in will be generated based on the patch number.
  75. 10.  To save display space, multiple patches may appear on any line; they do not have to be separated by commas.
  76. 11.  You can leave comments in the file just by typing in plain text, but be careful not to use any of these characters:
  77.     '(', ')', '[', ']', '{', '}', or '"' (double quote).
  78.